home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / manage / bconfg.arc / BCONFIG.DOC < prev    next >
Text File  |  1989-11-16  |  7KB  |  150 lines
  1.  
  2.                           ┌─────────────────────┐
  3.                           │     BConfig 1.2     │
  4.                           │BDEBUG config utility│
  5.                           │ copyright (C) 1989  │
  6.                           │     Jeff Bowles     │
  7.                           └─────────────────────┘
  8.  
  9.  
  10.  
  11.  
  12.      BCONFIG is a utility that allows you to customize the default
  13. states of the BDEBUG debugging program.  You can set the colors, window
  14. positions, window size, sleep/wake state, and the single/doublestrike
  15. state.  There is also an "animate" mode, which allows you to watch
  16. BDEBUG show each call at a selected rate, and stop on any interesting
  17. calls by hitting a key.
  18.  
  19.      BCONFIG can then write these defaults back out to your copy of
  20. BDEBUG.COM. The next time you load BDEBUG, the defaults you chose will
  21. already be set.
  22.  
  23.  
  24.                                 **********
  25.  
  26.  
  27.      Usage is fairly straightforward if you have used BDEBUG before; the
  28. menu looks about the same, and the keys work about the same.
  29.  
  30.      You will see a representation of the BDEBUG call window whenever
  31. you select the Window Size or Window Position options.  Feel free to
  32. move the window around and resize it until it looks good to you.  The
  33. same holds for the menu window; a representative menu window can be
  34. zoomed around the screen with the arrow keys.  Home, End, PgUp, PgDn and
  35. the 'center 5' key also can be used to move and resize windows.  These
  36. act as diagonal movement keys.
  37.  
  38.      Use F5 and F6 to set the foreground and background colors when the
  39. selection bar is on any of the three "Color" options.
  40.  
  41.     Move the selection bar to the "Single" / "Double" option.  By
  42. pressing enter repeatedly, you will cycle between SingleStrike,
  43. DoubleStrike, and Animate modes.  In Animate mode, the left and right
  44. arrows will adjust the relative speed of animation, with 00 being most
  45. rapid, and 99 being slowest.
  46.  
  47.     Press <ENTER> when the selection bar is on the CLONE option, and
  48. BCONFIG will look for your copy of BDEBUG in the current directory or
  49. along the search path.  It will write your preferences directly onto the
  50. patch areas of BDEBUG.
  51.  
  52.     If you clone BDEBUG with new colors or sizes or whatever, you may
  53. not see those changes reflected in the operation of BDEBUG until you
  54. reload BDEBUG.  This means that you may have to unhook BDEBUG and then
  55. reload it to see your changes.
  56.  
  57.     During operation of the newly cloned BDEBUG, all will be the same as
  58. usual with the exception of the Animate mode.  In the Animate mode,
  59. BDEBUG will not stop after each function call (assuming you're in
  60. SingleStrike). Instead, it will show the call and wait for a brief time
  61. before going on with the application program.  If you want to freeze a
  62. particular call for closer inspection, hit a key while the BDEBUG window
  63. is on the screen.  Hit another key to continue operation. 
  64.  
  65.                           ┌─────────────────────┐
  66.                           │     BConfig 1.2     │
  67.                           │BDEBUG config utility│
  68.                           │ copyright (C) 1989  │
  69.                           │     Jeff Bowles     │
  70.                           └─────────────────────┘
  71.  
  72.  
  73.  
  74.      You might wonder why BDEBUG.COM is included in the ARC file.  I
  75. have added a few btrieve error messages that were not around at the time
  76. Jacob Gafny wrote BDEBUG.  I also fixed a couple small spelling errors.
  77. This patched version of will display the name BDEBUG² at load-time, in
  78. case you ever need to differentiate the two versions.  BCONFIG will not
  79. fix the spelling errors or install the new error messages, so use the
  80. BDEBUG from the ARC if you want these changes.
  81.  
  82.      The source code is included for anyone interested.  You will need
  83. Turbo Pascal 5.0 and Turbo Professional Tools to recompile the source.
  84. Except for the animation code, BCONFIG doesn't really do anything fancy.
  85. It is just a gaudy shell to patch a few bytes in BDEBUG.COM.  You could
  86. do the same thing with Norton Utility or Debug or the like in about two
  87. minutes, but it wouldn't be quite as much fun.
  88.  
  89.      The bytes that are patched and their functions are found in
  90. BDEBUG.COM at the following offsets: (zero being the first byte of the
  91. file)
  92.  
  93.         offset   range          function
  94.         ------------------------------------------------------------------
  95.          $0F5F                  patched area for animation code (59 bytes)
  96.          $127F   0 - xx         Top row of BDEBUG call window
  97.          $1280   0 - xx         Left column of call window
  98.          $1281   $0B - xx       Vertical size of call window
  99.          $1282   $1F - xx       Horizontal size of call window
  100.          $1283   $00 - $01      SingleStrike - DoubleStrike
  101.          $26D5   $00 - $01      Asleep - Awake
  102.          $3A18   $00 - $7F      BDEBUG call window attribute
  103.          $3CFB   $00 - $7F      BDEBUG menu attribute
  104.          $3ADB   $0000 - $0F9E  Word offset of BDEBUG menu on screen
  105.          $3D18   $0000 - $0F9E  Word offset of BDEBUG menu selection bar
  106.          $3D2E   $00 - $7F      BDEBUG menu selection bar attribute
  107.  
  108. Credits: BCONFIG was written by me.
  109.          BDEBUG was written by Jacob Gafny
  110.          Turbo Pascal is a trademark of Borland.
  111.          Turbo Professional is a trademark of TurboPower Software.
  112.          Norton Utility is a trademark of Peter Norton Computing, Inc.
  113.  
  114.  
  115. License: BCONFIG 1.2 is (C) copyright 1989 by Jeff Bowles.  However,
  116.          anyone may use it in any way, as long as the copyright notice
  117.          remains intact, and only complete, unmodified copies of the
  118.          entire archive file are distributed.
  119.  
  120. Me:      I can be reached for questions, comments, etc. at the following:
  121.  
  122.                   Jeff Bowles                 Or leave message for
  123.                   1890 N. 4th St. #2A         me on CompuServe.
  124.                   Columbus, OH 43201          (CIS 76515,3433)
  125.                   (614) 294-8435
  126.  
  127.  
  128.                           ┌─────────────────────┐
  129.                           │     BConfig 1.2     │
  130.                           │BDEBUG config utility│
  131.                           │ copyright (C) 1989  │
  132.                           │     Jeff Bowles     │
  133.                           └─────────────────────┘
  134.  
  135.  
  136. Version History:
  137.  
  138.  11/16/89   1.2  Added ability to move the main BDEBUG menu.  Removed
  139.                  some redundant code.  Put a QUIET define in the source
  140.                  for those who hate squawky programs;  added a few
  141.                  noises for those who do.  Added monochrome detection,
  142.                  so no "invisible" color combinations can occur.
  143.  
  144.  05/17/89   1.1  Added animation to BDEBUG, cosmetic changes to source
  145.                  code & documentation.
  146.  
  147.  04/27/89   1.0  Original version; allows user to customize BDEBUG with
  148.                  colors, window size & location, and desired toggle
  149.                  modes.
  150.